home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / text / misc / paginate.readme < prev    next >
Text File  |  1993-04-27  |  3KB  |  68 lines
  1. Short: Does pagination and line numbering on files
  2.  
  3.     NAME
  4.     Paginate - Paginates a file or numbers the lines in a file
  5.  
  6.     SYNOPSIS
  7.     Paginate <infile >outfile -F/K -f0/K -f1/K -ff/K -H/K -h0/K -h1/K
  8.     -hf/K -N/K -t/K/N -b/K/N -l/K/N -r/K/N -p/K/N -T/S
  9.  
  10.         -F        Default Format String for Footers
  11.         -f0     Format String for Even Paged Footers
  12.         -f1     Format String for Odd Paged Footers
  13.         -ff     Format String for Footer on First Page
  14.         -H        Default Format String for Headers
  15.         -h0     Format String for Even Paged Headers
  16.         -h1     Format String for Odd Paged Headers
  17.         -hf     Format String for Header on First Page
  18.         -N        Printf Style Format String for Line Numbering
  19.         -t        Top Line for Each Page
  20.         -b        Bottom Line for Each Page
  21.         -l        Left Margin for Headers and Footers
  22.         -r        Relative Right Margin for Headers and Footers
  23.         -p        Number of First Page
  24.         -T        Title Page
  25.  
  26.     COPYRIGHT
  27.     Paginate Copyright (C) 1993 Fergus Duniho
  28.  
  29.     DESCRIPTION
  30.     This program divides a text file into pages of equal length, and it
  31.     optionally marks each page with a header, a footer, or both. The
  32.     headers and footers may contain the page number in various formats,
  33.     as well as the time and date in various formats. They may also
  34.     include any other text you want to put in them.
  35.  
  36.     You may choose different headers and footers for odd and even
  37.     pages, as well as for the first page. You may also choose to have
  38.     no header or footer on the first page, on odd pages, or on even
  39.     pages. And you may choose to have the same footer or header on all
  40.     pages.
  41.  
  42.     You may also choose to make the first page a title page. A title
  43.     page has no headers and footers on it. Also, "Paginate" does not
  44.     begin page numbering with a title page. And as far as the headers
  45.     and footers for the first page are concerned, "Paginate" does not
  46.     regard the title page as the first page. It considers it as the
  47.     page prior to the first page.
  48.  
  49.     HISTORY
  50.     I first needed a pagination program when I began writing my essays
  51.     with dme instead of with my word processor. I preferred dme because
  52.     it was faster and much more customizable, but it didn't have all
  53.     the nice features that my word processor had, including pagination.
  54.  
  55.     My first pagination program was an ARexx script called
  56.     Paginate.dme. This would put some lines at the beginning of a page,
  57.     and it would center the line number at the bottom of the page. It
  58.     would let me control such parameters as first page number and
  59.     number of lines per page.
  60.  
  61.     When I began writing XDMD, the soon to be released successor of
  62.     DMD, I decided that I wanted something better. I downloaded Pager
  63.     to see if it would suit my needs, and it didn't. So I wrote this
  64.     program, which is much more powerful than both Paginate.dme and
  65.     Pager. In my opinion, it completely replaces both.
  66.  
  67.     Fergus Duniho
  68.